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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 


The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 


The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 

SUBCONTRACTOR  ROLE 


Control  Data  Corporation 


D.  Appleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 
SCOPE 


1 . 1  Identification 

^  This  specification  establishes  the  design  of  a  number  of 
software  modules  necessary  for  the  precompiler  that  were  not 
addressed  in  any  of  the  NDML  Precompiler  Development 
Specification.  They  can  be  referred  to  as  PREO,  "NDML  Control 
Modules",  to  be  built  and  formally  accepted  by  the  ICAM  Program 
Office.  This  Cl  constitutes  one  of  the  subsystems  of  the  Common 
Data  Model  Processor  (CDMP) . 

x--"-- - _ 

1 . 2  Functional  Summary 

This  configuration  item  consists  of  the  following  software 
modules: 


1.  CDMOl,  APNAME 

2.  MAIN,  CDPRE 

3 .  CDECHK 

4 .  RPTERR 

5.  CDP13 

The  purpose  of  Computer  Program  Configuration  Item  (CPCI) 
and  a  brief  description  of  the  major  functions  follows: 

1.  CDMOl  is  designated  to  be  a  process  that 

accesses  an  ORACLE  database.  It  is  accessed  by  a  call 
to  the  module  APNAME.  It  determines  the  next  available 
name  to  use  for  a  software  module  that  is  to  be 
generated. 

2.  MAIN  and  CDPRE  are  designed  to  be  the  user  interface 
entry  point  and  top  level  NDML  precompiler  control 
module  respectively.  At  this  time,  the  user  interface 
is  the  NDML  precompiler  and  is  designed  to  be  a  simple 
batch-oriented  COBOL  program.  The  inputs  to  the 
precompiler  are  "ACCEPTED"  from  a  single  file  and  the 
outputs  (the  identification  of  generated  code)  are 
"DISPLAY"  output.  This  user  interface  main,  after 
having  assembled  the  input,  then  calls  CDPRE.  CDPRE  is 
the  callable  entry  point  to  the  precompiler  itself. 

The  precompiler  has  been  made  a  callable  routine  to 
support  many  other  user  interfaces  as  yet  unbuilt. 

CDPRE  is  essentially  a  control  routine  of  other 
designed  CPCI's  of  the  NDML  precompiler.  It  executes  a 
loop  while  over  the  user  input  file.  This  allows  for 
many  user  modules  of  a  single  logical  unit  of  work  to 
be  precompiled  at  the  same  time  (a  requirement  of  the 
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current  design) .  After  each  user  module  is 
precompiled,  CDECHK  is  called  to  perform  any  error 
handling  chores.  At  the  end  of  the  user's  batch,  CDP14 
(PRE14)  is  accessed  to  generate  the  necessary  request 
processor  main  routines. 

3.  CDECHK  is  a  module  that  localizes  all  error  checking 
and  handling  for  the  precompilation  of  a  single  user 
module.  If  the  precompile  was  successful,  a  record  of 
all  generated  code  is  stored  on  the  CDM  ORACLE 
database.  If  unsuccessful,  all  module  names  assigned 
and  generated  during  the  precompilation  process  must  be 
marked  as  re-useable. 

4.  A  generalized  routine,  RPTERR,  is  used  to  report  user 
errors  during  precompilation.  This  writes  the  specific 
message  into  an  error  file  that  contains  all  user  input 
code  along  with  the  interspersed  error  messages  in  much 
the  same  way  as  a  standard  COBOL  compiler. 

5.  CDP13  is  a  module  designed  to  control  all  code 
generation  activities  of  the  precompiler.  It  is  called 
by  PRES.  Input  to  CDP13  consists  of  the  logical 
specifications  for  each  subtransaction  to  be  generated. 
For  each  subtransaction,  APNAME  is  called  to  get  a  new 
name  for  the  module  to  be  generated  for  a  query,  PRES 
is  called  to  generate  the  CS  to  ES  transformer.  PREIO 
is  called  to  generate  code  into  the  user's  AP.  Also, 
one  of  the  DBMS  specific  code  generator's  is  called 
based  upon  the  type  of  DBMS  the  subtransaction  must 
access. 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 


1.  ICAM  Documentation  Standards:  IDS15012000A,  28 
December  1981. 

2.  D.  Appleton  Co.,  CDM  Administrators  Manual; 

UM620141000.  March  1984. 

3.  D.  Appleton  Co.,  CDMl-IDEFl  Model  of  the  Common  Data 
Model;  CCS620141000.  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (DS^  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDML  Precompiler; 
DS620141200.  October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer’s  Reference 
Manual;  PRM620141200 .  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer's  Guide;  UM620140001, 
July  1984. 

7.  Control  Data  Corp.,  Computer  Program  Development 
Specification  fPS^  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item;  NDDL  Command  ProcessorT 
DS620141100.  June  1985. 

2 . 2  Terms  and  Abbreviations 

Attribute  Use  Class;  (AUC) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor;  (CDMP) 

Common  Data  Model:  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 

Data  Field;  (DF)  An  element  of  data  in  the  external  schema.  It 
is  by  this  name  that  an  NDML  programmer  references  data. 

Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM  subsystem 
configuration  item  controls  the  execution  of  distributed  NDML 
queries  and  non  distributed  updates. 

Domain:  A  logical  definition  of  legal  attribute  class  values. 
Domain  Constraint:  Predicate  that  applies  to  a  single  domain. 
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External  Schema:  (ES) 

Forms:  Structured  views  which  may  be  imposed  on  windows  or 

other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor:  (FP)  A  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

Internal  Schema:  (IS) 

Integrated  Information  Support  System:  (IISS)  A  test  computing 
environment  used  to  investigate,  demonstrate  and  test  the 
concepts  of  information  management  and  information  integration 
in  the  context  of  Aerospace  Manufacturing.  The  IISS  addresses 
the  problems  of  integration  of  data  resident  on  heterogeneous 
databases  supported  by  heterogeneous  computers  interconnected 
via  a  local  Area  Network. 

Mapping:  The  correspondence  of  independent  objects  in  two 

schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the  coordination, 
communication  and  housekeeping  functions  required  to  integrate 
the  application  processes  and  system  services  resident  on  the 
various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language  developed 
by  the  IISS  project  to  provide  uniform  access  to  common  data, 
regardless  of  database  manager  or  distribution  criteria.  It 
provides  distributed  retrieved  and  single  node  updates. 

ORACLE:  Relational  DBMS  based  on  the  SQL  (Structured  Query 

Language,  a  product  of  ORACLE  Corp,  Menlo  Park,  CA) .  The  CDM  is 
an  ORACLE  database. 

Parcel:  A  sequential  file  containing  sections  source  code  of 
the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy  a 
retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface:  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI.  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Description 

A  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI.  Since  only  those  modules  of  this 
CPCI  are  shown  in  Section  3.10,  the  user  is  referred  to  the 
diagrams  of  Section  3.3  to  show  how  these  modules  control  the 
CPCI's  of  the  NDML  precompiler. 

3 . 2  Functional  Flow 

A  single  execution  of  the  NDML  precompiler  may  have  many 
logical  units  of  work,  each  consisting  of  a  batch  of  user 
modules.  MAIN  controls  this  loop.  Each  batch  consists  of  many 
user  modules  which  may  be  precompiled  successfully  or 
unsuccessfully.  This  loop  is  controlled  by  CDPRE.  Error 
handling  logic,  for  each  user  module,  is  controlled  by  CDECHK. 
Many  NDML  statements  may  be  found  in  each  user  module.  This 
logic  is  controlled  by  PRE2.  Each  NDML  statement  may  require 
many  conceptual  transactions  (the  original  request  plus  any 
integrity  tests)  which  is  controlled  by  PRE4 .  Each  conceptual 
transaction  may  require  many  internal  schema  subtransactions. 
This  is  determined  by  PRES.  The  generation  of  code  for  each 
subtransaction  is  controlled  by  CDP13. 

3.3  Interfaces 


The  following  diagram  depicts  the  interface  of  PREO  with 
other  CPCI's  in  the  system. 
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I  MAIN  I 
+ - + — + 

-+CDPRE  +- 
+- 
+- 

+ — + - + 


+ - + - +  + - + - +  + - + - +  + - + - +  + - + - + 

PREl  PRE2  I  I  PREll  PRE14 

PS41211  PS41212  1  |PS41259  CDECHK  PS41261 

+ - +  + - + - +  + - +  + - +  + - + 

PRE4 
PS41231 
+ - + - + 

PRES 

PS41232 


+ - + 

- +  CDP13  +- 

+ - ++ - + - ++ 


++- 


APNAME 

PRE6 

PRE7 

+ - + 

PS41251 
+ - + 

PS41252 
+ - + 

I  PS41260 


+ - + - + 

PRES 
PS41253 
+ - + 


+-+ - + 

PREIO 
PS41258 
+ - + 


+ — +  PRE9.2 
I  PS41254 
+ - + 

+ - + 

I  PRE9 . 3 
+ — +  PS41255 
+ - - - + 


3.3.1  Input/Outputs 


The  following  tables  depict  the  inputs  and  outputs  of  each 
module  in  this  CPCI.  A  detailed  description  for  each  item  can 
be  found  in  the  DS  for  this  CPCI. 


MODULE:  CDMOl 

INPUT 


OUTPUT 


— NONE — 
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MODULE :  APNAME 

INPUT _ OUTPUT 

DBMS  Name  Application  Process 

Name 

Module  Status 

MODULE :  CDPRE 

INPUT  '  OUTPUT 


Application  Process  Input  File 
Error  File 

Application  Process  Target  Host 
Users  Application  Process  Name 


Code  Generator  Table 
Number  of  Good 
Precompiles 
Number  of  Bad 
Precompiles 
Module  Status 


MODULE :  CDECHK 

INPUT _ OUTPUT 

Precompile  Status  Module  Status 

Last  Module  Used 

Users  Module  Name 

Current  Host 

Target  Host 

Parcel  1 

Parcel  2 

Parcel  3 

Parcel  4 

Source  Language 

Code  Generator 

Oracle  Logon  Data  Area 


3 . 4  Program  Interrupts 

Not  applicable  to  this  CPCI. 

3 . 5  Timing  and  Sequencing  Description 
Not  applicable  to  this  CPCI. 

3 . 6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3 . 7  Storage  Allocation 
3.7.1  Database  Definition 


The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  This  model  is  defined  by  the  CDMl,  the  IDEFl 
model  of  the  CDM,  Reference  Number  3. 
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3.7. 1.1  File  Description 

No  permanent  files  have  been  defined  for  this  CPCI.  It  may 
use  temporary  scratch  files  for  such  things  as  generated  program 
source  code  or  temporary  query  results. 

3. 7. 1.2  Table  Description 

Not  applicable  to  this  CPCI. 

3. 7. 1.3  Item  Description 
•  « 

Not  applicable  to  this  CPCI. 

3 . 8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  test  team  by  using  defined  IISS  Software 
Configuration  Management  Procedures.  This  CPCI  will  use  the 
COBOL  language  compiler. 

3 . 9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL.  The  intent  was 
to  provide  a  transportable  system.  Any  system  environment 
supporting  this  language,  a  virtual  memory  management  scheme, 
the  COMM  and  NTM  subsystem  of  IISS  and  the  ORACLE  Database 
Management  System  should  be  able  to  support  this  CPCI.  Every 
possible  attempt  has  been  made  to  localize  and  identify  any 
machine  or  environment  dependent  modules  through  the  original 
design  of  the  IISS  and  application  of  Configuration  Management 
Procedures. 
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3.10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 


3.10.1  Where  Include  File  Used  List 

The  following  lists  each  include  file  in  the 
documentation  group  and  all  the  modules  documented  in  this 
specification  which  include  them.  The  purpose  of  each 
module  is  listed  as  well. 


DOCGROUP  PS41200  Where-include~f ile-used  List 


Include  Module 

File  Name 


ERRCDM 

APNAME 

BLDCC 

CDCJOB 

CDDGAP 

CDECHK 

CDFOl 

CDFIRP 

CDFLRP 

CDFORP 

CDGDF 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDP13 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRSFN 

CDRTSND 

CDSLFN 

CDUPDLW 

CDUPDNM 

CDVERSM 


3-5 


PS  620341200 
30  September  1990 


DOCGROUP  PS41200  Where-include-f ile-used  List 

Include  Module 

File  Name 


ERRPRO 


GENRPD 

LOGANA 

MAIN 

RCMOD 

APNAME 

BLDCC 

CDCJOB 

CDDGAP 

CDECHK 

CDFOl 

CDFIRP 

CDFLRP 

CDFORP 

CDGDF 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDP13 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRSFN 

CDRTSND 
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DOCGROUP 


Include 

File 


CHKCDM 


PS41200  Where-include-f ile-used  List 


Module 

Name 


CDSLFN 

CDUPDLW 

CDUPDNM 

CDVERSM 

GENRPD 

LOGANA 

MAIN 

RCMOD 

RPTERR 

BLDCC 

CDDGAP 

CDECHK 

CDFORP 

CDGDF 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDLKLUW 

CDP13 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

LOGANA 
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DOCGROUP  PS41200  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

RCMOD 

CCTABLE 

BI,DCC 

SBSTLST 

CCCJOB 

ERRFS 

CDCJOB 

CDECHK 

CDFORP 

CDGDF 

CDP13 

CDPRE 

GENRPD 

MAIN 

RPTERR 

CGTABLE 

CDCJOB 

CDECHK 

CDFIRP 

CDFORP 

CDP13 

CDPRE 

GENRPD 

MAIN 

FLDELST 

CDCJOB 

CDECHK 

CDPRE 

CDRPXRF 

CDVERSM 

MAIN 
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DOCGROUP 

Include 

File 

EOD 


ALFABET 

ISAL 

ISQUAL 

CHAT 

FORVAR 

P5DFS 


PS41200  Where-include-f ile-used  List 


Module 

Name 


CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDNM 

CDVERSM 

CDFOl 

CDGDF 

CDP13 

CDGDF 

CDP13 

CDGDF 

CDP13 


CDGJF 

CDP13 
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DOCGROUP  PS41200  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

CDIDFU 

APAT 

CDP13 

APINFO 

CDP13 

APRK 

CDP13 

APGC 

CDP13 

SUBPROC 

CDP13 

BOOLST 

CDP13 

CSQUAL 

CDP13 

JQGTBL 

CDP13 

APL 

CDP13 

SETTAB 

CDP13 

RFTABLE 

CDP13 

ESAL 

CDP13 

ESQUAL 

CDP13 

UVABBR 

CDP13 

CSAL 

CDP13 
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DOCGROUP  PS41200  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

OCCTAB 

CDP13 

SUBBOOL 

CDP13 

BLSTACK 

CDP13 

CURTAB 

CDP13 

WHENTAB 

CDP13 

SQLVAR 

CDPRE 

FILSTAT 

GENRPD 

MAIN 

RPTERR 

SRVRET 

GENRPD 

RCMOD 

3.10.2  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
in  the  documentation  group  and  all  the  documented  modules 
which  call  it.  The  purpose  of  each  module  is  listed  as 
well . 
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DOCGROUP  PS41200  Where-external -routine-used  List 


System  Module 

Module  Name 


CDMOl 

ERRPRO 


APNAME 

APNAME 

BLDCC 

CDCJOB 

CDDGAP 

CDECHK 

CDFOl 

CDFIRP 

CDFLRP 

CDFORP 

CDGDF 

CDIDFU 

CDIDIU 

CDIGAP 

COINS LW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDP13 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRSFN 

CDRTSND 

CDSLFN 

CDUPDLW 


3-12 


PS  620341200 
30  September  1990 


DOCGROUP  PS41200  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDUPDNM 

CDVERSM 

GENRPD 

LOGANA 

MAIN 

RCMOD 

RPTERR 

GENFIL 

CDCJOB 

CDFORP 

OPNFIL 

CDCJOB 

CDECHK 

CDPRE 

GENRPD 

MAIN 

CLSFIL 

CDCJOB 

CDECHK 

CDPRE 

GENRPD 

MAIN 

CDMACR 

CDCJOB 

OUTFIL 

CDCJOB 

CDECHK 

CDGDF 

CDPRE 

RPTERR 

SQLSCA 
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DOCGROUP 


System 

Module 


SQLBSl 


PS41200  Where-external-routine-used  List 


Module 

Name 


CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

COINS LW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 


3-14 


PS  620341200 
30  September  1990 


DOCGROUP  PS41200  Where-external-routine-used  List 


System  Module 

Module  Name 


CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

SQLSCH 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

COINS LW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 
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DOCGROUP  PS41200  Where-external-routine-used  List 


System  Module 

Module  Name 


CDVERSM 

SQLSCC 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

SQLTFL 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 
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DOCGROUP 


System 

Module 


SQLOPN 


SQLOSQ 


PS41200  Where-external-routine-used  List 


Module 

Name 


CDINSNM 

CDINSSM 

CDIRSU 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

CDDGAP 
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DOCGROUP 


System 

Module 


SQLADR 


PS41200  Where-external-routine-used  List 


Module 

Name 


CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 
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DOCGROUP  PS41200  Where-external-routine-used  List 


System  Module 

Module  Name 


CDLKLUW 

CDPRE 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

SQLABl 

CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIGAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDIU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 
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DOCGROUP 


System 

Module 


SQLEXE 


SQLWNR 


SQLTOC 


PS41200  Where-external-routine-used  List 


Module 

Name 


CDDGAP 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

GDI GAP 

CDINSLW 

CDINSNM 

CDINSSM 

CDIRSU 

CDLKLUW 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDRPXRF 

CDRTSND 

CDUPDLW 

CDUPDNM 

CDVERSM 

CDDGAP 

CDFOl 

CDIDFU 

CDRPDFU 

CDRPESU 

CDRPRSU 

CDUPDLW 

CDUPDNM 
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DOCGROUP 


System 

Module 


SQLADl 


SQLFCH 


SQLCLS 


PS41200  Where-external-routine-used  List 


Module 

Name 


CDFOl 

CDIDFU 

CDLKLUW 

CDRPXRF 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIRSU 

CDLKLUW 

CDRPXRF 

CDRTSND 

CDVERSM 

CDFOl 

CDFIRP 

CDFLRP 

CDIDFU 

CDIDIU 

CDIRSU 

CDLKLUW 

CDRPXRF 

CDRTSND 

CDVERSM 

CDFOl 

CDIDFU 

CDLKLUW 

CDRPXRF 
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DOCGROUP  PS41200  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDPIC 

CDGDF 

CDCREFO 

CDGDF 

CDGETOF 

CDGDF 

CDS DATE 

CDIGAP 

CDINSNM 

CDINSSM 

CDUPDNM 

CDPRE8 

CDP13 

CDPRE8C 

CDP13 

CDPRE8D 

CDP13 

CDPIO 

CDP13 

CDQPS 

CDP13 

CDQPC 

CDP13 

CDPRE6 

CDP13 

CDPRE7 

CDP13 

SQLLOl 

CDPRE 

CDDBMSS 

CDPRE 
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DOCGROUP  PS41200  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDVERSM 

CDVERLW 

CDPRE 

CDPREl 

CDPRE 

CDPRE2 

CDPRE 

CDPll 

CDPRE 

CDSLMN 

CDPRE 

CDRSMN 

CDPRE 

INPFIL 

CDPRE 

GENRPD 

MAIN 

UNPLINE 

CDPRE 

CURLCNT 

CDPRE 

PROEXEC 

CDPRE 

CDRPSM 

CDRPXRF 

CDP14 

GENRPD 

LOWUPP 

MAIN 

CDFUNC 

RCMOD 
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DOCGROUP  PS41200  Where-external-routine-used  List 


System 

Module 

NSEND 

RCV 


Module 

Name 


RCMOD 

RCMOD 


3.10.3  Main  Program  Parts  List 

The  following  lists  each  Main  Program  in  the 
documentation  group  and  all  the  modules  which  are  called 
either  by  that  module  itself  or  by  any  of  the  documented 
modules  which  it  calls.  It  is  possible  for  a  non-main 
module  to  be  listed  more  that  once  if  it  is  called  by 
multiple  modules.  The  called  modules,  in  this  case  known  as 
program  parts,  are  marked  as  to  whether  they  are  documented 
here.  If  so,  the  phrase  "well-defined  module"  appears  by 
the  module  name,  if  not  it  is  an  "external  "routine".  The 
Purpose  of  the  Main  Program  module  is  listed  as  well. 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 
Name 

APNAME 

BLDCC 

CDCJOB 


CDDGAP 


CDECHK 


Module 

Name 

Module 

Type 

CDMOl 

External 

routine 

ERRPRO 

External 

routine 

ERRPRO 

External 

routine 

ERRPRO 

External 

routine 

GENFIL 

External 

routine 

OPNFIL 

External 

routine 

CLSFIL 

External 

routine 

CDMACR 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 

ERRPRO 

External 

routine 

OPNFIL 

External 

routine 

CLSFIL 

External 

routine 

OUTFIL 

External 

routine 

CDUPDNM 

Well-defined  module 
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DOCGROUP 


Main  Pgm 
Name 


CDFOl 


CDFIRP 


PS41200  Main  Program  Parts  List 


Module 

Module 

Name 

Type 

CDIGAP  Well-defined  module 


CDINSSM 

Well-defined  module 

CDUPDLW 

Well-defined  module 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 

SQLTOC 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLCLS 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 
Name 


CDFLRP 


CDFORP 


CDGDF 


CDIDFU 


Module 

Name 

Module 

Type 

SQLEXE 

External 

routine 

SQLAOl 

External 

routine 

SQLFCH 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

ERRPRO 

External 

routine 

GENFIL 

External 

routine 

CDFIRP 

External 

routine 

APNAME 

External 

routine 

CDFLRP 

External 

routine 

ERRPRO 

External 

routine 

OUTFIL 

External 

routine 

CDPIC 

External 

routine 

CDCREFO 

External 

routine 

CDGETOF 

External 

routine 

ERRPRO 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDIDIU 


CDIGAP 


PS41200  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLAOR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 

SQLTOC 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLCLS 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

ERRPRO 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDINSLW 


CDINSNM 


PS41200  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

CDSDATE 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDINSSM 


CDIRSU 


PS41200  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

CDS DATE 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

CDS DATE 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SQLFCH 

External 

routine 

CDLKLUW 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLTOC 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLCLS 

External 

routine 

CDP13 

ERRPRO 

External 

routine 

APNAME 

External 

routine 

CDPRE8 

External 

routine 

CDPRE8C 

External 

routine 

CDPRE8D 

External 

routine 

CDPIO 

External 

routine 

CDFORP 

External 

routine 

CDQPS 

External 

routine 

CDQPC 

External 

routine 

CDPRE 6 

External 

routine 

CDPRE7 

External 

routine 

CDPRE 

ERRPRO 

External 

routine 

OPNFIL 

External 

routine 

CLSFIL 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDRPDFU 


PS41200  Main  Program  Parts  List 


Module 

Module 

Name 

Type 

OUTFIL 

External 

routine 

SQLSCA 

External 

routine 

SQLADR 

External 

routine 

CDUPDNM 

Well-defined  module 

SQLLOl 

External 

routine 

CDDBMSS 

External 

routine 

CDVERLW 

External 

routine 

CDPREl 

External 

routine 

CDVERSM 

Well-defined  module 

CDPRE2 

External 

routine 

CDPll 

External 

routine 

CDSLFN 

Well-defined  module 

CDSLMN 

External 

routine 

CDRSFN 

Well-defined  module 

CDRSMN 

External 

routine 

CDCJOB 

External 

routine 

RPTERR 

Well-defined  module 

CDECHK 

External 

routine 

INPFIL 

External 

routine 

UNPLINE 

External 

routine 

CURLCNT 

External 

routine 

PROEXEC 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDRPESU 


CDRPRSU 


CDRPXRF 


PS41200  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLWNR 

External 

routine 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLTOC 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLCLS 

External 

routine 

CDRPRSU 

External 

routine 

CDRPDFU 

External 

routine 

CDRPSM 

External 

routine 

CDRSFN 

ERRPRO 

External 

routine 

CDFOl 

External 

routine 

CDRTSND 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 
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DOCGROUP  PS41200  Main 


Main  Pgm 

Module 

Name 

Name 

SQLADl 

SQLFCH 

CDSLFN 

ERRPRO 
CDF  01 

CDUPDLW 

ERRPRO 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

CDUPDNM 

ERRPRO 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

Program  Parts  List 

Module 
Type 


External  routine 
External  routine 

External  routine 
External  routine 

External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 

External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CDS DATE 

External 

routine 

CDVERSM 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

CDINSSM 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

CDDBMSS 

External 

routine 

CDLKLUW 

External 

routine 

CDRPXRF 

External 

routine 

CDRPESU 

External 

routine 

CDDGAP 

External 

routine 

CDINSNM 

External 

routine 

GENRPD 

ERRPRO 

External 

routine 

OPNFIL 

External 

routine 

CLSFIL 

External 

routine 

INPFIL 

External 

routine 

CDP14 

External 

routine 

LOGANA 

ERRPRO 

External 

routine 

MAIN 
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DOCGROUP  PS41200  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

ERRPRO 

External 

routine 

OPNFIL 

External 

routine 

CLSFIL 

External 

routine 

INPFIL 

External 

routine 

LOWUPP 

External 

routine 

CDPRE 

External 

routine 

RCMOD 

ERRPRO 

External 

routine 

CDFUNC 

External 

routine 

NSEND 

External 

routine 

RCV 

External 

routine 

RPTERR 

ERRPRO 

External 

routine 

OUTFIL 

External 

routine 

3.10.4  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  in  the 
documentation  group  being  documented  in  this  specification. 
It  provides  a  compact  way  of  getting  information  that  would 
be  otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 


Name  of  program  Module. 


PURPOSE : 


Purpose  of  Module  as  detailed  in  the 
source  code. 


LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-1  Workbench  'C') 

VAX- 11  COBOL 


MODULE 

TYPE: 

Whether  a  Program,  Subroutine, 
Function. 

SOURCE 

FILE: 

Name  of  Source  File  from  file 
specification. 

SOURCE 

FILE  TYPE: 

Source  File  Extension  from  file 
specification. 
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HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 


Whether  this  is  a  host-  endent 
routine  (VAX  or  IBM)  o^  jj.ank  if 
host-independent . 

IISS  sub-system  this  file  resides  in. 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION:  A  description  of  the  module  as  otained 

from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 


INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 


CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM (S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.3. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 


DOCGROUP  PS41200  Module  Documentation 


NAME:  APNAME 

PURPOSE:  INTERFACES  WITH  THE  MODULE  NAME  ASSIGNER 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  APNAME 

SOURCE  FILE  TYPE:  COB 

HOST  t 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 

DESCRIPTION: 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  MODULE  NAME 
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QUEUE  SERVER.  IT  WILL  GET  NEW  NAMES. 

MOD  2.0  STANDARDIZED  ERROR  HANDLING, 

MODIFIED  FOR  RELEASE  2.2  -  IGNORE  UNSOLICITED  MESSAGES 

(AUGUST  1986) 

MODIFIED  FOR  RELEASE  2.3  (2 . 2 . 5) -RECEIVE  A  BLOCK  OF  20  NAMES 
AND  HAND  OUT  ONE  AT  A  TIME. 

MOD  FOR  2.3- 

CALL  CDMOl  DIRECTLY  WHICH  WILL  USE  DATA  BASE  AND  HAND 
OUT  ONE  NAME  AT  A  TIME. 


ARGUMENTS : 


DBMS -NAME 

AP-NAME 

RET-STATUS 


DSPLY[X(30) ] 
DSPLY[X(10) 3 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

ERRPRO 


ROUTINES  CALLED: 


CDMOl 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  BLDCC 

PURPOSE:  BUILDS  CONTROL  CARD  FOR  RCL 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  BLDCC 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  BUILDS  THE  CONTROL  CARD  FROM  THE 
CONTROL-CARD-TABLE,  CODE  GENERATOR 
TABLE,  AND  FUNC  PASSED  FROM  CDRCL. 
THIS  CARD  WILL  THEN  BE  TAKEN  BY  CDRCL 
AND  USED  IN  THE  NTM  ROUTINE  'SNDRCLE' 
CALLED  BY  CDRCL. 
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ARGUMENTS : 


TARGET-HOST 

FILE-MOD-NAME 

FUNC 

CTL-CARD 

RET-STATUS 


DS PLY [XXX] 
DSPLY[X(30) ] 
DSPLY[X(30) ] 
DSPLY[X(72) ] 
DSPLY[X(5)  ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

CCTABLE 

ERRPRO 


ROUTINES  CALLED: 
ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDCJOB 

PURPOSE;  CREATE  A  PROCEDURE  TO  COMPILE  ALL  GENERATED  CODE 

LANGUAGE;  VAX- 11  COBOL 

SOURCE  FILE:  CDCJOB 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


THIS  ROUTINE  WILL  USE  THE  CODE-GENERATOR-TABLE 
TO  CREATE  A  PROCEDURE  FILE  THAT  WILL  COMPILE 
ALL  GENERATED  CODE.  IT  WILL  USE  GENFIL  TO  GET  A  NAME 
FOR  THE  PROC  FILE  AND  NAMES  FOR  THE  TEMPORARY  FILES 
THAT  MAY  BE  NEEDED.  THE  PROCEDURE  USED  FOR  EACH 
FILE  WILL  DEPEND  ON  THE  TYPE  OF  CODE  IT  IS 
(USER  MOD,  RP-SUB,  CS-ES  ETC)  AND  A  COMBINATION 
OF  THE  PROGRAM'S  LANGUAGE,  HOST  AND  DBMS. 

2/23/88  -  UPDATED  TO  FIOPS  FOR  UNIX  REHOST. 

8/01/88  -  UPDATED  TO  ACCEPT  "HP"  OR  "PYR"  AS  MY-HOST  AND 
GENERATE 

A  MAKEFILE  IF  SO. 

12/6/88  -  UPDATE  CODE  FOR  PYR  TO  REFLECT  DIFFERENCES  IN 
PYRAMID  AND 
HP  MAKEFILES. 
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2/01/89  “  UPDATED  CODE  FOR  PYR  TO  ALLOW  MORE  THAN  50  MODULES 
IN  A 

COMPILE  GROUP. 

12/13/89  -  UPDATED  TO  NOT  DO  A  LIB/DELETE  IF  OBJECTS  WERE  ON  A 
REMOTE  HOST.  INSTEAD  A  NEW  FILE  WILL  GET  GENERATED  WITH 
PROPER  HOST  COMMANDS  TO  DELETE  THEM  ON  THE  REMOTE  HOST. 

THIS  FILE  WILL  THEN  GET  SENT  BY  GENAP  TO  THE  PROPER 
MACHINE  TO  RUN.  (NOTE:  LOGIC  ONLY  IN  FOR  REMOTE  HOST 
BEING  IBM) 


ARGUMENTS : 


CODE-GENERATOR-TABLE 

MY-HOST 

FILE-DELETE-LIST 

COMP-PROC-FILE 

RET-STATUS 


INCLUDE  FILES: 


ERRCDM 

SBSTLST 

ERRFS 

CGTABLE 

FLDELST 

ERRPRO 


ROUTINES  CALLED: 


GENFIL 

OPNFIL 

CLSFIL 

ERRPRO 

CDMACR 

OUTFIL 

DOCGROUP  PS41200  Module  Documentation 
NAME:  CDDGAP 

PURPOSE:  DROP  ALL  REFERENCES  OF  GENERATED  MODULE  (AP) 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDDGAP 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 

DESCRIPTION: 


RECRD 
DS PLY [XXX] 
RECRD 

DSPLY[X(80)  ] 
DSPLY[X(5)  ] 


USE  SQL  TO  DELETE  ALL  ROWS  FROM  THE  GENERATED  MODULE 
CDM  TABLE  FOR  A  USER  MODULE  BEING  RE-PRECOMPILED. 
REWRITTEN  FOR  RELEASE  2.3,  NEW  CDM  TABLES  AND  USE  SQL 


3-41 


PS  62034120C 
30  September  1990 


DSPLY[X(10) ] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 


ARGUMENTS : 


MOD- ID 
RET-STATUS 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

RRRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDECHK 

PURPOSE:  PROVIDE  PRECOMPILER  ERROR  CHECKING 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDECHK 

SOURCE  FILE  TYPE:  COB 

HOST  * 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


THIS  ROUTINE  WILL  TEST  THE  RET-STATUS  AT  END  OF 
PRECOMPILING  ONE  USER  MODULE.  IF  GOOD  THEN 
INSERT  ALL  NEW  REFERENCES  IN  THE  CDM  AND  DELETE 
UNNEEDED  FILES.  DELETE  OBSOLETE  CODE  AT  THE  USERS 
OPTION.  IF  BAD,  THEN  DELETE  ANY  SCRATCH  FILES. 

2/22/88  CONVERTED  TO  FIOPS  FOR  UNIX  REHOST. 
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ARGUMENTS : 


PREC-STATUS 

LAST-CGT-USED 

LAST-FDL-USED 

USER-MOD-ID 

MY-HOST 

TARGET-HOST 

FCBl 

FCB2 

FCB3 

FCB4 

PARCLl 

AP- LANGUAGE 

CODE-GENERATOR-TABLE 

FILE-DELETE-LIST 

FILE-DELETE-OPTION 

LUW-NAME 

LAST-CASE-  NO 

RET-STATUS 


DSPLY[X(5)  ] 
DSPLYtS9 (9)  ] 
DSPLY[S9 (9)  ] 
DSPLY[X(10)  ] 
DS PLY [XXX] 
DSPLY[XXX] 
DSPLY[S9(9) ] 
DSPLY[S9(9)  ] 
DSPLY[S9(9)  ] 
DSPLY[S9 (9)  ] 
DSPLY[X(80)  ] 
DSPLY[X(10)  ] 
RECRD 
RECRD 

DSPLY[X(4)  ] 
DSPLY[X(30)  ] 
DSPLY[9 (6) ] 
DSPLY[X(5) ] 


INCLUDE  FILES; 


ERRCDM 

CHKCDM 

ERRFS 

CGTABLE 

FLDELST 

ERRPRO 


ROUTINES  CALLED: 


ERRPRO 

CDUPDNM 

CDIGAP 

CDINSSM 

CLSFIL 

OPNFIL 

CDUPDLW 

OUTFIL 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDFOl 

PURPOSE;  THIS  ROUTINE  GENERATES  UNIQUE  FILE  NAMES 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDFOl 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 
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DESCRIPTION: 


-  CDFOl  IS  A  QUEUE  SERVER  RESIDENT  ON  ONLY  ONE  PLACE 
IN  THE  TEST  BED.  WHEN  CALLED  WITH  A  HOST  ID,  IT  WILL 
REPLY  WITH  THE  NEXT  FILE  NAME  TO  USE  FOR  TEMPORARY 
RESULTS  OF  QUERY  PROCESSORS , AGGREGATORS ,  AND 
THE  C  TO  E  TRANSFORMS,  ETC. 

MOD  FOR  2.0 

SEND  OUT  MANY  FILE  NAMES  ON  1  REQUEST 

WRAP  FILE  NUMBERS  AROUND  AND  INCREMENT  LETTER 

SAVE  FILE  NAMES  USED  PERIODICALLY  ON  A 

SAVE -FILE 

MOD  FOR  2.2.5 

ADD  WORKAROUND  FOR  NTM  SHUTDOWN  PROBLEM: 

SAVE  FILE  NAMES  WHENEVER  THERE  IS  NO 
OUTSTANDING  REQUEST.  USE  CHKMSG  EVERY 
TIME  A  REPLY  IS  SENT,  IF  NO  MESSAGES  ARE 
ARE  READY,  THEN  SAVE  THE  NAMES  IN  THE  FILE. 

MOD  FOR  2.3 

SCRAP  USE  OF  Q-SERVER  APPROACH.  THIS  IS  NOW 
A  SUBROUTINE  WHICH  WILL  USE  A  SQL  TABLE  TO  GET 
A  FILE  NAME  FOR  THE  HOST  DESIRED.  BEFORE  THE 
COMMIT  POINT,  IT  WILL  UPDATE  THE  DATA  BASE  WITH 
THE  LAST  USED  FILE  NAME,  IF  CALLED  WITH  THE 
FETCH-SAVE-FLAG  SET  TO  ''S''. 


ARGUMENTS : 

FETCH-SAVE -FLAG 

DSPLY[X] 

FILE-HOST 

DS PLY [XXX] 

NEW-FILE-NAME 

DSPLY[X(80) ] 

RET-STATUS 

DSPLY[X(5) ] 

INCLUDE  FILES: 

ERRCDM 

EOD 

ALFABET 

ERRPRO 

ROUTINES  CALLED: 

ERRPRO 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTOC 

SQLOSQ 

SQLADR 

SQLABl 
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SQLEXE 

SQLADl 

SQLFCH 

SQLCLS 

SQLTFL 

SQLOPN 

SQLWNR 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDFIRP 

PURPOSE:  FIND  NAME  OF  AN  EXISTING  REQUEST  PROCESSOR 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDFIRP 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  NAME  OF  A  LOGICAL  UNIT  OF  WORK  BEING  PRECOMPILED 
AND  THE  DATA  BASE  ID  OF  A  SUBTRANSACTION,  THIS  ROUTINE  WILL 
DO  A  DATA  BASE  SEARCH  TO  DETERMINE  THE  NAME  OF  THE 
REQUEST  PROCESSOR.  IF  FOUND,  THE  NAME  OF  THE  RP  DRIVER  WILL 
BE  ADDED  TO  THE  CODE  GENERATOR  TABLE. 

SEARCH  THE  GENERATED_MOD  TABLE  FOR  THE  ENTRY  FOR 

THE  PARTICULAR  RP  DRIVER  NEEDED  (USE  THE  LUW  NAME  AND 

THE  DB-ID) .  IF  NOT  FOUND  RETURN  THIS  FACT.  IF  FOUND, 

RETURN  THE  LOCALITY  AND  THE  MOD-ID  OF  THE  RP  DRIVER  AND 
STORE  AN  ENTRY  IN  THE  CODE-GENERATOR-TABLE  TO  PREVENT 
FURTHER  DATA  BASE  SEARCHES  OF  THIS  TYPE  IN  THIS  PRECOMPILE 
SESSION. 


ARGUMENTS : 


LUW-NAME 

DB-ID 

MOD-ID 

LOCALITY 

FOUND-FLAG 

CODE-GENERATOR-TABLE 

SUB-LANG 

RET-STATUS 


DSPLY[X(30) ] 
DSPLY[9(6)  ] 
DSPLY[XU0)  ] 
DSPLY[X] 
DSPLY [ 9 ] 
RECRD 

DSPLY[X(10) ] 
DSPLY[X(5) ] 
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INCLUDE  FILES: 


ERRCDM 

EOD 

CGTABLE 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDFLRP 

PURPOSE:  FIND  THE  NAME  OF  THE  LOCAL  REQUEST  PROCESSOR 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDFLRP 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  LOGICAL  UNIT  OF  WORK,  FIND  THE  NAME  OF  THE 
LOCAL  REQUEST  PROCESSOR  (IF  ANY)  BY  SEARCHING  THE 
GENERATED  MODULE  TABLE. 


ARGUMENTS : 


LUW-NAME 
FOUND- FLAG 
RET-STATUS 


DSPLY[X(30) ] 
DSPLY [ 9 ] 
DSPLY[X(5)  ] 
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INCLUDE  FILES: 


ERRCDM 

EOD 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDFORP 

PURPOSE:  FIGURE  OUT  THE  NAME  OF  THE  REQUEST  PROCESSOR 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDFORP 

SOURCE  FILE  TYPE:  COB 

HOST  • 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


DETERMINE  THE  NAME  OF  THE  RP  DRIVER  FOR  A  PARTICULAR 
SUBTRANSACTION  AND  WHETHER  IT  IS  REMOTE  OR  LOCAL 
GIVEN  THE  LOGICAL  UNIT  OF  WORK  NAME  AND  THE  DATA  BASE  ID 
BY  SEARCHING  THE  CODE  GENERATOR  TABLE  OR  THE  CDM. 

STORE  THE  NAME  OF  THE  RP  DETERMINED  IN  THE  CODE  GENERATOR 
TABLE  IF  IT  WAS  FOUND  ON  THE  DATA  BASE.  IF  NOT  FOUND 
ANYWHERE  USE  THE  MODULE  NAMER  TO  BUILD  UP  A  NEW  NAME. 

FIRST  CHECK  THE  CODE  GENERATOR  TABLE  FOR  AN  ENTRY  FOR  THE 
DBID  OF  THE  SUBTRANSACTION,  IF  FOUND,  RETURN  THE  NAME  OF  THE 
RP  AND  ITS  LOCALITY.  IF  IT  IS  NOT  IN  THE  TABLE,  CALL  CDFIRP 
WHICH  WILL  SEARCH  THE  CDM  FOR  THE  NEEDED  RP  NAME  AND  IF  FOUND 
STORE  A  REFERENCE  IN  THE  CODE  GENERATOR  TABLE.  IF  CDFIRP 
FOUND  IT,  THIS  ROUTINE  WILL  RETURN  THE  NAME  AND  LOCALITY 
FROM  THE  DATA  BASE  SEARCH.  IF  CDFIRP  DID  NOT  FIND  THE 
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RP  DRIVER,  THEN  WE  MUST  ACCESS  THE  MODULE  NAMER  WITH  A 
CALL  TO  APNAME.  THEN  WE  MUST  LOOK  TO  SEE  IF  IT  IS  GOING 
TO  BE  A  LOCAL  OR  REMOTE  RP.  WE  CALL  CDFLRP  TO  DETERMINE 
IF  THERE  ARE  ANY  OTHER  LOCAL  RP'S.  IF  THERE  ARE,  THIS  ONE  MUST 
BE  REMOTE.  IF  NOT,  IT  COULD  BE  LOCAL  ONLY  IF  THERE  ARE  NO 
LOCALS  IN  THE  CODE  GENERATOR  TABLE  AND  IT  IS  TO  RUN  ON  THE  SAME 
HOST  AS  THE  TARGET  HOST  OF  THE  USER'S  AP.  IF  THE  RP  IS  TO  BE 
REMOTE  WE  MUST  BUILD  THE  RP  MAIN  AP  NAME  BY  CONCATENATING  THE 
NTM-DIRECTORY  THE  MODULE  NAME  AND  THE  TRAILING  ZZZ'S  REQUIRED 
BY  THE  NTM. 


ARGUMENTS : 


DBID 

LUW-NAME 

DBMS -NAME 

NTM-DIRECTORY 

RP-SUB-HOST 

DB-NAME 

TARGET-HOST 

MY-HOST 

CODE -GENERATOR-TABLE 

SUB-LANG 

RP-MAIN-NAME 

LOCALITY 

RET-STATUS 


DSPLY[9(6) ] 
DSPLY[X(30) ] 
DSPLY[X(30)  ] 
DSPLY[XX] 

DS PLY [XXX] 
DSPLY[X(30) ] 
DS PLY [XXX] 
DSPLY[XXX] 
RECRD 

DSPLY[X(10) ] 
RECRD 
DSPLY[X] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

CGTABLE 

ERRPRO 


ROUTINES  CALLED: 


CDFIRP 

APNAME 

CDFLRP 

GENFIL 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 
NAME:  CDGDF 

PURPOSE:  GENERATES  WS  VARIABLE  DEFINITIONS  AND  INDICATORS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDGDF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 
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DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  WORKING  STORAGE 
AND  INDICATORS  FOR  RECEIVING  FIELDS  INTO 
A  SQL  REQUEST  SUBROUTINE  —  5/20/86. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  CODE  IN  COBOL,  C,  OR  FORTRAN 

Update  8/89  to  allow  for  an  extra  character  in  a  'c'  character 
string  to  hold  a  null  terminator  -  needed  for  ingres5  and 
ingres6 


ARGUMENTS : 


IS-ACTION-LIST 

IS-QUALIFY-LIST 

COMPLEX-MAPPING-ALG-TABLE 

SUBTRANS-ID 

FCB“W 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

STRING-EXPANSION-FLAG 

RET-STATUS 


RECRD 
RECRD 
RECRD 
DSPLY[999] 
DSPLY[S9 (9) ] 
DSPLY[X(10) ] 
RECRD 
DSPLY[X] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

ISAL 

ISQUAL 

CMAT 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDIDFU 

PURPOSE:  INSERT  INTERNAL  SCHEMA  DATA  FIELD  USAGE  CROSS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDIDFU 

SOURCE  FILE  TYPE:  PCO 

HOST  l 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  GENERATED  MODULE  NAME  AND  THE  DATA  FIELD 
NUMBER  USED  AND  ITS  USAGE  CODE  (SELECT,  INSERT,  ETC...) 
STORE  A  SINGLE 

CROSS  REFERENCE  IN  THE  DATA_FIELD_USAGE  TABLE. 

MOVE  ALL  INPUTS  TO  WORKING  STORAGE.  DO  THE  INSERT  AND 
TEST  FOR  ERROR  CODES. 


ARGUMENTS : 


GEN-MOD-ID 

DF-NO 

DF-USAGE-CODE 

DF-TABLE-LIST 

RET-STATUS 


INCLUDE  FILES: 


ERRCDM 

EOD 

P5DFS 

ERRPRO 


DSPLY[X(10) ] 
DSPLY[9 (6) ] 
DSPLY[X] 
RECRD 

DSPLY[X(5)  ] 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

SQLTOC 

SQLWNR 

SQLCLS 

ERRPRO 


REF 
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DOCGROUP  PS41200  Module  Documentation 
NAME:  CDIDIU 

PURPOSE:  INSERT  EXTERNAL  SCHEMA  USAGE  CROSS  REFERENCE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDIDIU 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


GIVEN  THE  NAME  OF  THE  USER  MODULE  BEING  PRECOMPILED 
AND  EITHER  THE  NUMBER  OF  THE  DATA  ITEM  OR  THE 
VIEW  REFERENCED  AND  A  CODE  INDICATING  HOW  THE 
VIEW  OR  DATA  ITEM  IS  USED  (SELECT,  MODIFY,  ETC.) 

THIS  ROUTINE  WILL  PERFORM  A  RELATIONAL  INSERT  FOR  THE 
ES  USAGE  TABLE. 


MOVE  VARIABLES  TO  WORKING  STORAGE,  SET  UP  NULL 
INDICATORS.  BOTH  DATA  ITEM  AND  VIEW  BEING  NULL 
IS  AN  ERROR.  DO  THE  INSERT,  CHECK  FOR  ANY  ERROR. 


ARGUMENTS : 


USER-MOD-ID 

DI-NO 

VIEW-NO 

USAGE-CODE 

RET-STATUS 


DSPLY[X(10) ] 
DSPLY[9 (6) ] 
DSPLY[9(6)  ] 
DSPLY[X] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

EOD 

ERRPRO 

ROUTINES  CALLED: 


ERRPRO 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 
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DOCGROUP  PS41200  Module  Documentation 
NAME:  CDIGAP 

PURPOSE:  INSERT  A  ROW  INTO  THE  GENERATED  MODULE  CDM  TABLE 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDIGAP 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


THIS  ROUTINE  WILL  STORE  A  SINGLE  ROW  INTO  THE 
CDM  TABLE  GENERATED  MODULE  WHICH  RECORDS  ALL 
TYPES  OF  MODULES  GENERATED  BY  THE  NDML 
PRECOMPILER.  IT  USES  AN  SQL  INSERT  AND  IT  USES 
THE  DBMS  FACILITY  FOR  TODAY'S  DATE  AND  TIME. 

ALL  OTHER  VALUES  ARE  PASSED  AS  INPUT. 

EACH  INPUT  VALUE  MUST  BE  TESTED  AS  SPACES  OR 
ZERO  IN  CASE  A  NULL  VALUE  MUST  BE  REPRESENTED. 

ARGUMENTS : 


GENERATE D-MOD- I D 

USER-MOD-ID 

GENERATED-BY 

MODULE-TYPE 

CASE-NO 

IS-ACTION 

FILE-NAME 

HOST-ID 

DB-ID 

LUW-NAME 

LOCAL-REMOTE 

SUBTRANS-ID 

RET-STATUS 

INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


CDS DATE 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

ERRPRO 


DSPLY[X(10)  ] 
DSPLY[X(10)  ] 
DSPLY[X(10)  ] 
DSPLY[X(10)  ] 
DSPLY[9(6)  ] 
DSPLY[X] 
DSPLY[X(80)  ] 
DSPLY[X(3)  ] 
DSPLY[9 (6) ] 
DSPLY[X(30) ] 
DSPLY[X] 
DSPLY[9 (6) ] 
DSPLY[X(5) ] 
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DCCGROUP  PS41200  Module  Documentation 


NAME:  COINS LW 

PURPOSE:  INSERT  A  ROW  INTO  THE  LOGICAL  UNIT  OF  WORK  TABLE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDINSLW 

SOURCE  FILE  TYPE:  PCO 

HOST  z 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


WHEN  THE  USER  PRECOMPILES  THE  FIRST  TIME  AGAINST  A 
LOGICAL  UNIT  OF  WORK,  IT  WILL  NOT  BE  FOUND  ON  THE 
CDM  DATA  BASE.  THIS  ROUTINE  WILL  STORE  THE  NEW 
ROW  FOR  THE  GIVEN  LOGICAL  UNIT  OF  WORK  NAME.  THE 
LAST  CASE  NUMBER  USED  INTERNALLY  BY  THE  PRECOMPILER 
IS  INITIALIZED  TO  ZERO.  AFTER  PRECOMPILATION,  IT  IS 
COURSE  UPDATED  TO  THE  LAST  USED  VALUE. 


ARGUMENTS : 

LUW-NAME  DSPLY [ X ( 3  0 ) ] 

RET-STATUS  DSPLY [ X { 5 ) ] 

INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 


NAME:  CDINSNM 

PURPOSE:  INSERT  A  NEW  ROW  IN  THE  NDML  MODULE  TABLE 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDINSNM 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  NAME  OF  THE  USER  MODULE  BEING  PRECOMPILED 
FOR  THE  FIRST  TIME,  ITS  LOGICAL  UNIT  OF  WORK 
STORE  A  NEW  ROW  IN  THE  CDM  TABLE  NDML  MODULE  WITH 
THE  SYSTEM  DATE  AS  THE  DATE  IT  WAS  FIRST  PRECOMPILED. 


DSPLY[X(30) ] 
DSPLY[X(10) ] 
DSPLY[X(5)  ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 


ARGUMENTS : 


LUW-NAME 

MOD-ID 

RET-STATUS 


ROUTINES  CALLED: 


CDS DATE 

SQLSCA 

SQLBSl 

SQLSCH 

5QLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 


NAME:  CDINSSM 

PURPOSE:  INSERT  A  NEW  ROW  INTO  THE  SOFTWARE  MODULE  TABLE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDINSSM 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  NAME  OF  THE  SOFTWARE  MODULE,  IT  SOURCE 
LANGUGE,  THIS  ROUTINE  WILL  INSERT  A  NEW  ROW  INTO 
THE  SOFTWARE  MODULE  TABLE  OF  THE  CDM.  THIS  IS 
USED  TO  RECORD  USER  WRITTEN  SOFTWARE  MODULES  THAT 
HAVE  BEEN  PRECOMPILED. 


DSPLY[X(10) ] 
DSPLY[X(10)  ] 
DSPLY[X(5)  ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


ARGUMENTS : 


MOD-ID 

SOURCE-LANGUAGE 

RET-STATUS 


CDS DATE 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 


NAME:  CDIRSU 

PURPOSE:  INSERT  INTERNAL  SCHEMA  RECORD  SET  USAGE  CROSS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDIRSU 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


GIVEN  THE  GENERATED  MODULE  NAME  AND  THE  RECORD  SET 
NUMBER  USED  IN  A  SUBTRANSACTION,  STORE  A  SINGLE 
CROSS  REFERENCE  IN  THE  RECORD_SET_USAGE  TABLE. 

MOVE  ALL  INPUTS  TO  WORKING  STORAGE.  DO  THE  INSERT  AND 
TEST  FOR  ERROR  CODES. 


ARGUMENTS : 


GEN-MOD-ID  DSPLY[X{10)] 

SET-NO  DSPLY[9(6)] 

RET-STATUS  DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

EOD 

ERRPRO 

ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

ERRPRO 


REF 
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DOCGROUP  PS41200  Module  Documentation 


NAME;  CDLKLUW 

PURPOSE:  VERIFY  AND  LOCK  A  LOGICAL  UNIT  OF  WORK  OCCURRENCE. 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDLKLUW 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


USE  SQL  TO  SELECT  A  SINGLE  ROW  FROM  THE  CDM  TABLE 
LOGICAL  UNIT  OF  WORK  FOR  THE  LOGICAL  UNIT  OF  WORK 
BEING  PRECOMPILED  BY  THE  USER.  IF  FOUND,  RETRIEVE 
THE  LAST  CASE  NUMBER  ASSIGNED  FOR  THIS  LOGICAL  UNIT 
OF  WORK  AND  LOCK  THE  ROW  FROM  OTHER  USERS  THAT  MAY 
TRY  TO  CHANGE  THIS  LOGICAL  UNIT  OF  WORK. 


ARGUMENTS : 


LUW-NAME 

LAST-CASE-NO 

RET-STATUS 


DSPLY[X(30) ] 
DSPLY[9(6)  ] 
DSPLY[X(5)  ] 


INCLUDE  FILES; 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTOC 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

SQLCLS 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 


NAME:  CDP13 

PURPOSE:  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDP13 

SOURCE  FILE  TYPE:  COB 

HOST  • 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  CDP13  IS  CALLED  FOR  EACH  CONCEPTUAL 
TRANSACTION  AFTER  THE  CS-IS  TRANSFORM 
DONE  BY  CDPRE5  IS  COMPLETE. 

IT  PROCESSES  THE  SUBTRANSACTIONS 
IDENTIFIED  BY  THE  CS  TO  IS  DECOMPOSER, 

DETERMINING  WHICH  DBMS  EACH  SUBTRANS 
APPLIES  TO,  AND  TAKING  THE  APPROPRIATE 
ACTION  FOR  EACH. 

MOD  FOR  REL  2.3: 

ADD  CALLS  TO  PRE8C,  PRE8D  TO  GENERATE  CS/CS  TRANSFORMS 
FOR  AN  INNER  SELECT  AND  TO  GENERATE  CS/CS  TRANSFORM  FOR  A 
REFERENTIAL  INTEGRITY  TEST  WITH  OR  LOGIC  PRESENT. 

ALSO,  USE  DATA  BASE  LOOKUPS  TO  DETERMINE  THE  NAME  OF  THE 
RP  DRIVER  (AND  ITS  LOCALITY)  FOR  EACH  RP  SUB. 


ARGUMENTS : 


SUBTRANS - PROCESS - ID-TABLE 

IS-ACTION-LIST 

IS-QUALIFY-LIST 

ES-ACTION-LIST 

ES-QUALIFY-LIST 

CS-ACTION-LIST 

UV-ABBR-LIST 

CS-QUALIFY-LIST 

JQG 

JQG-ATTRIBUTE-PAIR-LIST 

SET-TABLE 

RFT 

OCCURS -TABLE 

COMPLEX-MAPPING-ALG-TABLE 

MY-HOST 

TARGET-HOST 

FCB-1 

FCB-2 

FCB-3 

FCB-4 

FCB-E 


RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

DSPLY[XXX] 

DSPLY[XXX] 

DSPLY[S9 (9) ] 

DSPLY[S9 (9)  ] 

DSPLY[S9 (9) ] 

DSPLY[S9  (9)  ] 

DSPLY[S9  (9)  ] 
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LUW-NAME 
BOOLEAN-LIST 
SUBTRANS - BOO LEAN -LIST 
SOURCE-LANGUAGE 
SUB-LANG 

CODE -GENERATOR-TABLE 

BLOCK-STACK 

FIRST-INNER-SELECT 

FORTRAN-VARI ABLE -TABLE 

EMBEDDED-LANGUAGE 

CURSOR-TABLE 

WHENEVER-TABLE 

RET-STATUS 


DSPLY[X(30) ] 

RECRD 

RECRD 

DSPLY[X(10) ] 

DSPLY[X(10) ] 

RECRD 

RECRD 

DSPLY[9] 

RECRD 

DSPLY[X(10) ] 
RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

APAT 

APINFO 

APRK 

APGC 

SUBPROC 

ISAL 

ISQUAL 

BOOLST 

CSQUAL 

JQGTBL 

APL 

SETTAB 

RFTABLE 

ESAL 

ESQUAL 

CMAT 

UVABBR 

CSAL 

OCCTAB 

SUBBOOL 

BLSTACK 

FORVAR 

CGTABLE 

CURTAB 

WHENTAB 

ERRPRO 

ROUTINES  CALLED: 


APNAME 

CDPRE8 

CDPRE8C 

CDPRE8D 

CDPIO 

CDFORP 

CDQPS 

CDQPC 

CDPRE6 

CDPRE7 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 


NAME:  CDPRE 

PURPOSE:  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML  PRECOMPILER 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDPRE 

SOURCE  FILE  TYPE:  PCO 

HOST : 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  IS  THE  MAIN  ENTRY  POINT  FOR  THE  NDML  PRECOMPILER 
ON  INPUT  THE  USER  INTERFACE  HAS  BEEN  PERFORMED. 

FIRST  VERIFY  AND  LOCK  THE  LOGICAL  UNIT  OF  WORK.  THEN 
CALL  CDPRE 1  TO  BREAK  APART  THE  USER'S 
SOFTWARE  MODULE  INTO  THE  FOUR  PARCELS,  THEN  CALL 
CDVERSM  TO  VERIFY  THE  SOFTWARE  MODULE  AND  DELETE 
ITS  CROSS  REFERENCES  AND  THEN  CALL 


ARGUMENTS : 


AP-FILE-IN 

ERROR-FILE 

MY-HOST 

AP-TARGET-HOST 

LUW-NAME 

CDM-USER-NAME 

FILE-DELETE-OPTION 

SUB-LANG 

SOURCE-LANGUAGE 

EMBEDDED-LANGUAGE 

CODE-GENERATOR-TABLE 

FILE-DELETE-LIST 

GOOD-PRECOMPI LES 

BAD-PRECOMPILES 

COMP-PROC-FILE 

RET-STATUS 


DSPLY[X(80) ] 
DSPLY[X(80)  ] 
DSPLY[XXX] 
DSPLY[XXX] 
DSPLY[X(30) ] 
DSPLY[X(30) ] 
DSPLY[X(4) ] 
DSPLY[X(10)  ] 
DSPLY[X(10)  ] 
DSPLY[X(10)  ] 
RECRD 
RECRD 

DSPLY[S9  (9)  ] 
DSPLY[S9  (9)  ] 
DSPLY[X (80) ] 
DSPLY[X(5)  ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

SQLVAR 

CGTABLE 

FLDELST 

ERRPRO 
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ROUTINES  CALLED: 


OPNFIL 

SQLSCA 

SQLADR 

SQLLOl 

CDDBMSS 

CDVERLW 

CDPREl 

CDVERSM 

CDPRE2 

CDPll 

CDSLFN 

CDSLMN 

CDRSFN 

CDRSMN 

CDCJOB 

CLSFIL 

ERRPRO 

RPTERR 

CDUPDNM 

CDECHK 

OUTFIL 

INPFIL 

UNPLINE 

CURLCNT 

PROEXEC 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDRPDFU 

PURPOSE:  DROP  ALL  REFERENCES  TO  DATA  FIELD  FOR  A  GIVEN  MODULE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPDFU 

SOURCE  FILE  TYPE:  PCO 

HOST  * 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


USE  SQL  TO  DELETE  ALL  ROWS  FROM  THE  DATA  FIELD 
USAGE  CDM  TABLE  FOR  A  GIVEN  SOFTWARE  MODULE. 


ARGUMENTS : 


DSPLY[X(10) ] 
DSPLY[X(5) ] 


MOD-ID 

RET-STATUS 
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INCLUDE  FILES: 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 
NAME;  CDRPESU 

PURPOSE;  DROP  ALL  EXTERNAL  SCHEMA  REFERENCES  FOR  A  GIVEN 
MODULE 

LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDRPESU 
SOURCE  FILE  TYPE:  PCO 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


USE  SQL  TO  DELETE  ALL  ROWS  FROM  THE  EXTERNAL  SCHEMA 
USAGE  CDM  TABLE. 

ARGUMENTS : 


MOD-ID  DSPLY[X(10)] 

RET-STATUS  DSPLY  t  X ( 5 )  ] 

INCLUDE  FILES; 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 
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ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

ERRPRO 

DOCGROUP  PS41200  Module  Documentation 
NAME:  CDRPRSU 

PURPOSE:  DROP  ALL  REFERENCES  TO  RECORD  SET  FOR  A  GIVEN  MODULE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPRSU 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 

DESCRIPTION: 


USE  SQL  TO  DELETE  ALL  ROWS  FROM  THE  RECORD  SET 
USAGE  CDM  TABLE  GIVEN  A  SOFTWARE  MODULE  NAME. 

ARGUMENTS : 


MOD-ID  DSPLY[X(10)] 

RET-STATUS  DSPLY [ X ( 5 ) ] 

INCLUDE  FILES; 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 
NAME:  CDRPXRF 

PURPOSE:  DROP  REFERENCES  TO  GENERATED  CODE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPXRF 

SOURCE  FILE  TYPE:  PCO 

HOST  i 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 

DESCRIPTION: 


GIVEN  THE  NAME  OF  THE  USER  MODULE  BEING  PRECOMPILED 
OR  DROPPED,  THIS  ROUTINE  WILL  SEARCH  THE  CDM (AS-BUILT) 
TABLE  "GENERATED  MODULE"  TO  DETERMINE  ALL  GENERATED 
MODULES  ASSOCIATED  WITH  THE  GIVEN  INPUT  USER  MODULE  NAME. 
FOR  EACH  ONE  OF  THESE  FOUND,  A  ROUTINE  WILL  BE  CALLED 
TO  DELETE  IT  FROM  CROSS  REFERENCE  TABLES  DATA  FIELD  USAGE, 
RECORD  SET  USAGE  AND  FROM  THE  SOFTWARE  MODULE  TABLE 
ITSELF.  EACH  FILE  NAME  AND  HOST  OF  THE  GENERATED  CODE  IS 
RECORDED  IN  THE  FILE-DELETE-LIST 


ARGUMENTS : 


DSPLY[X(10) ] 
DSPLY[X(4) ] 
RECRD 

DSPLYCX(5) ] 

INCLUDE  FILES: 


CHKCDM 

ERRCDM 

EOD 

FLDELST 

ERRPRO 

ROUTINES  CALLED: 


USER-MOD-ID 

FILE-DELETE-OPTION 

FILE-DELETE-LIST 

RET-STATUS 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTOC 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

CDRPRSU 

CDRPDFU 

CDRPSM 

SQLCLS 

ERRPRO 
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DOCGROUP  PS41200  Module  Documentation 
NAME:  CDRSFN 

PURPOSE:  RESET  FILE  NAME  ASSIGNMENT  TABLE  TO  BEGINNING 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRSFN 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


THIS  ROUTINE  WILL  SET  THE  PROPER  FLAG  TO  CALL 
CDFOl  TO  RESET  AND  CLEAR  THE  FILE  NAME  TABLE 
THIS  ROUTINE  SHOULD 

BE  CALLED  BEFORE  ANY  FILE  NAMES  ARE  TO  BE  HANDED  OUT 
(AN  EMPTY  TABLE  WILL  FORCE  A  DATA  BASE  RETRIEVAL  OF  THE 
LAST  FILE  NAME  USED)  AND  IT  SHOULD  BE  CALLED  IN  THE 
EVENT  OF  A  ROLLBACK. 

ARGUMENTS : 


RET-STATUS  DSPLY [ X ( 5 ) ] 

INCLUDE  FILES: 


ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


CDFOl 

ERRPRO 


DOCGROUP  PS412>00  Module  Documentation 


NAME:  CDRTSND 

PURPOSE:  RETRIEVES  INTERNAL  SCHEMA  METADATA 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRTSND 

SOURCE  FILE  TYPE:  PCO 

HOST  * 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  USE  THE  DATA  BASE  ID  AND  RECORD 
ID  AND  ACCESS  THE  CDM  FOR  FOR  ITS  INTERNAL  TYPE, 

SIZE  AND  NUMBER  OF  DECIMAL  DIGITS. 
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SELECT  DATA  TYPE,  SIZE  AND  NUMBER  OF  DECIMAL  DIGITS 
FOR  A  PARTICULAR  DFID  AND  RTID.  IF  NOT  FOUND, 
GENERATE  AN  ERROR  MESSAGE. 


ARGUMENTS : 


DFID 

RTID 

DBID 

IS-TYPE 

IS-SIZE 

IS-ND 

RET-STATUS 


DSPLY[X(30) ] 
DSPLY[X(30)  ] 
DSPLY[9 (6)  ] 
DSPLY[X] 
DSPLY[999] 
DSPLY[99] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

EOD 

ERRPRO 


ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDSLFN 

PURPOSE:  SAVE  LAST  FILE  NAME  ASSIGNED 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDSLFN 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


3-66 


PS  620341200 
30  September  1990 


DESCRIPTION: 


THIS  ROUTINE  WILL  SET  THE  PROPER  FLAG  TO  CALL 
CDFOl  TO  DO  A  DATA  BASE  SAVE  OF  THE  LAST  FILE 
NAME  USED  FOR  EACH  HOST.  THIS  ROUTINE  SHOULD 
BE  CALLED  AFTER  ALL  FILE  NAMES  NEEDED  ARE  OBTAINED 
AND  JUST  BEFORE  THE  COMMIT  POINT. 


ARGUMENTS : 

RET-STATUS  DSPLY [ X ( 5 ) ] 

INCLUDE  FILES: 

ERRCDM 

ERRPRO 


ROUTINES  CALLED: 


CDFOl 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 
NAME:  CDUPDLW 

PURPOSE:  UPDATE  THE  LAST  CASE  NUMBER  ON  THE  LOCKED  LUW  ROW 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDUPDLW 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


GIVEN  THE  NAME  OF  THE  LOGICAL  UNIT  OF  WORK  BEING 
PRECOMPILED,  AND  THE  LAST  ASSIGNED  CASE  NUMBER 
AFTER  A  SUCCESSFUL  PRECOMPILATION,  UPDATE  THE 
LOCKED  LOGICAL  UNIT  OF  WORK  ROW. 


ARGUMENTS : 


DSPLY [X( 30) ] 
DSPLY [9 (6) ] 
DSPLY [X (5) ] 


LUW-NAME 

LAST-CASE-NO 

RET-STATUS 
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INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDUPDNM 

PURPOSE:  UPDATE  NDML  MODULE  WITH  PRECOMPILATION  STATUS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDUPDNM 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


ARGUMENTS : 


MOD-ID 
STATUS -CODE 
RET-STATUS 

INCLUDE  FILES: 


DSPLY[X(10) ] 
DSPLY[X] 
DSPLY[X(5) ] 


CHKCDM 

ERRCDM 

EOD 

ERRPRO 

ROUTINES  CALLED: 


CDS DATE 
SQLSCA 
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SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLWNR 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  CDVERSM 

PURPOSE:  VERIFY  SOFTWARE  MODULE  TO  BE  PRECOMPILED 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDVERSM 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


LOOK  UP  THE  NAMED  SOFTWARE  MODULE  AS  BEING  A  PREVIOUSLY 
DEFINED  NDML  MODULE.  IF  FOUND  COMPARE  ITS  LOG  UNIT  OF  WORK 
TO  THE  ONE  THE  USER  SAYS  HE  IS  PRECOMPILING.  IF  THEY  ARE 
NOT  THE  SAME,  THE  USER  HAS  MADE  AN  ERROR.  IF  THEY  ARE  THE 
SAME  ALL  CROSS  REFERENCES  SHOULD  BE  DELETED  (IDENTIFYING  ALL 
OBSOLETE  GENERATED  CODE,  PERFORMED  BY  CDRPXRF) .  WE 
SHALL  THEN  DROP  ALL  EXTERNAL  SCHEMA  CROSS  REFERENCES  TO  THIS 
NDML  MODULE.  IF  THE  SOFTWARE  MODULE  IS  NOT  FOUND  IT  IS  NEW. 

IN  THIS  CASE  WE  MUST  INSERT  AN  OCCURRENCE  OF  NDML  MODULE  AND 
SOFTWARE  MODULE.  THE  INSERTS  IN  THIS  CASE  WILL  BE  COMMITED 
AND  THE  LOCK  ON  THE  LOGICAL  UNIT  OF  WORK  RE-OBTAINED  (CDLKLUW) . 


ARGUMENTS : 


USER-MOD- ID 

LUW-NAME 

SOURCE-LANGUAGE 

LUW-LOCK-STATUS 

FILE-DELETE-LIST 

FILE-DELETE-OPTION 

LAST-CASE-NO 

RET-STATUS 


DSPLY[X(10) ] 
DSPLY[X(30)  ] 
DSPLY[X(10)  ] 
DSPLY[9] 
RECRD 

DSPLY[X(4) ] 
DSPLY[9 (6)  ] 
DSPLY[X(5) ] 
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INCLUDE  FILES: 


CHKCDM 

ERRCDM 

EOD 

FLDELST 

ERRPRO 


ROUTINES  CALLED: 


CDLKLUW 

SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

CDRPXRF 

CDRPESU 

CDDGAP 

CDINSSM 

CDINSNM 

CDDBMSS 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  GENRPD 

PURPOSE:  GENERATE  GENRPD  REQUEST  PROCESSOR  DRIVER  ROUTINES 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  GENRPD 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  ACTS  AS  1  OF  POSSIBLY  MANY 
USER  INTERFACE  FRONT-ENDS  TO  THE  GENRPD 
REQUEST  PROCESSOR  DRIVER.  IT  WILL  OBTAIN 
THE  LOGICAL  UNIT  OF  WORK  NAME  FROM  THE  USER 
THAT  HE  WISHES  TO  HAVE  RP  DRIVERS  GENERATED  FOR. 
IT  WILL  THEN  CALL  THE  CDP14  ROUTINE  WHICH  WILL 
HANDLE  THE  CODE  GENERATION.  ON  COMPLETION  OF 
THE  CALL,  RETURN  STATUS  WILL  BE  INTERPRETED  FOR 
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FIRST  OF  ALL  ESTABLISH  CONNECTION  WITH  NTM  VIA  INITEX 
THEN  OPEN  AND  READ  INPUT  FILE  OF  COMMANDS,  AND  FOR  EACH 
CARD  CALL  THE  CDP14  GENERATOR.  AFTER  A  SUCCESSFUL 
EXECUTION,  REPORT  PERTINENT  INFORMATION  TO  THE  USER 
USING  A  FORMATTED  DISPLAY.  WHEN  FINISHED  DISCONNECT 
WITH  NTM  WITH  A  TRMNAT  CALL. 


INCLUDE  FILES: 


FILS TAT 

ERRCDM 

ERRFS 

SRVRET 

CGTABLE 

ERRPRO 


ROUTINES  CALLED: 


OPNFIL 

INPFIL 

CDP14 

CLSFIL 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  LOGANA 

PURPOSE:  DETERMINES  ERROR  STATUS  OF  RCL  FUNCTION 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  LOGANA 

SOURCE  FILE  TYPE:  COB 

HOST  * 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDDL 

DESCRIPTION: 


-  SCANS  THE  LOG  FILE  RETURNED  FROM 
NTM  ROUTINE  'SNDRCLE'  VIA  'RCV 
FOR  ANY  ERRORS  IN  THE  COMPILE  OR 
LINK  WHICHEVER  ONE  WAS  SELECTED. 
CALLED  BY  CDRCL. 


ARGUMENTS : 


DSPLY[X(30) ] 
DSPLY[XXX] 


LOG-FILE-NAME 

TARGET-HOST 
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DS PLY [XXX] 
DSPLY[X(10) ] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


ERRPRO 

INCLUDE  FILES: 


CURRENT-HOST 

ERROR-KEYWORD 

RET-STATUS 


FILSTAT 

ERRCDM 

ERRFS 

CGTABLE 

FLDELST 

ERRPRO 

ROUTINES  CALLED: 


OPNFIL 

INPFIL 

LOWUPP 

CDPRE 

CLSFIL 

ERRPRO 


DOCGROUP  PS41200  Module  Documentation 


NAME:  RCMOD 

PURPOSE:  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS  REUSABLE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  RCMOD 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDDL 

DESCRIPTION: 


THIS  ROUTINE  MUST  BE  USED  TO  MARK  ALL  PREVIOUSLY 
ASSIGNED  MODULES  GENERATED  FOR  THE  USER  MODULE  NAME 
AS  REUSEABLE.  IT  EXPECTS  THE  NAME  OF  A  USER  MODULE. 

MODIFIED  FOR  RELEASE  2.2  -  IGNORE  UNSOLICITED  MESSAGES 

(AUGUST  1986) 
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ARGUMENTS : 


DSPLY[X(10) ] 
DSPLY[X(5) ] 

INCLUDE  FILES: 


SRVRET 

ERRCDM 

CHKCDM 

ERRPRO 

ROUTINES  CALLED: 


CDFUNC 

NSEND 

RCV 

ERRPRO 


USER-MOD-NAME 

RET-STATUS 


DOCGROUP  PS41200  Module  Documentation 


NAME:  RPTERR 

PURPOSE:  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP  LISTING 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  RPTERR 

SOURCE  FILE  TYPE:  C 

HOST: 

SUBSYSTEM:  NTM 
SUBDIRECTORY:  MPU 


DESCRIPTION: 


THIS  PROGRAM  OUTPUTS  ERROR  MESSAGES  TO  AP 
LISTING  FROM  PRECOMPILER-ENCOUNTERED  ERRORS. 
THIS  ROUTINE  SIMPLY  OPENS  THE  LISTING  AT  END, 
WRITES  THE  MESSAGE  AND  CLOSES  THE  LISTING. 

ARGUMENTS : 


FCB-F  DSPLY[S9(9)] 

ERRMESS  DSPLY[X(60)] 

INCLUDE  FILES; 


ERRFS 
FILS TAT 
ERRPRO 

ROUTINES  CALLED: 


OUTFIL 

ERRPRO 
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3.10.5  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  in  the  documentation  group  as  specified  in 
the  source  code.  The  language  it  is  written  in  is  also  given. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ALFABET 

PURPOSE:  LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  IS  THE  ENGLISH  ALPHABET,  THE  LETTERS  ARE  USED 
FOR  ASSIGNING  THE  NEXT  UNIQUE  NAME  WHEN  THE 
NUMBERS  RUN  OUT. 

ALFABET. INC 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  APAT 

PURPOSE:  ACCESS  PATH  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  ACCESS  PATH  FOR  ONE  SUBTRANSACTION 
FOR  A  NDML  REQUEST. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  APGC 

PURPOSE:  GENERIC  CODASYL  COMMAND  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


HOLDS  THE  GENERIC  CODASYL  DML  COMMANDS  FOR  AN 
ACCESS  PATH  OF  AN  NDML  REQUEST 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  APINFO 

PURPOSE:  ACCESS  PATH  INFORMATION  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


THIS  IS  A  COLLECTION  OF  INFORMATION  STORED  IN  A 

NUMBER  OF  VARIOUS  TABLES  USED  BY  THE  ACCESS  PATH  TABLE 
AND  THE  GENERIC  CODASYL  TABLE.  SEE  CDMP  SPEC,  PRE6 


APINFO. INC 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  APL 

PURPOSE:  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  ABOUT  THE  JOIN 
ATTRIBUTES  FOR  NDML  SUBTRANSACTIONS 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  APRK 

PURPOSE:  TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  FOR  THE  KEYS  OF 
RECORDS  CONTAINED  IN  THE  CURRENT  ACCESS 
PATH 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  BLSTACK 

PURPOSE;  FORTRAN  VARIABLE  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  ^S41200  Include  File  Description 


FILE  NAME:  BOOLST 
PURPOSE:  BOOLEAN  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  BOOLEAN  OPERATORS,  PARENTHESES,  AND 
pointers  to  the  type  2  CONDITIONS  FOR  AN  NDML 
TRANSACTION 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CCTABLE 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION; 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CGTABLE 

PURPOSE:  CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED  SOFTWARE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


HOLDS  PERTINENT  RESULTS 

ABOUT  ALL  CODE  GENERATED  OR  MODIFIED  BY  THE 
PRECOMPILER 
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DOCGROUP  PS41200  Include  File  Description 
FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE  * 

CDMP  MODULES  * 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CMAT 

PURPOSE:  COMPLEX  MAPPING  ALGORITHM  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  IDENTIFIES  THE  SOFTWARE  MODULES  AND 
PARAMETERS  THAT  ARE  NEEDED  TO  PERFORM  COMPLEX 
MAPPINGS  BETWEEN  CS  AND  IS  FORMATS 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CSAL 

PURPOSE:  CONCEPTUAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


TABLE  TO  HOLD  CONCEPTUAL  DATA  ABOUT  THE  REQUEST 

NOTEl!!!!!  This  table  is  cloned  in  both  cdpre5  and  cdpre4 
so  any  changes  made  to  this  structure  needs  to 
be  made  in  these  cloned  versions.  Clone  version 
is  CSALX  for  CDPRF-. . 

NOTE  AGAIN  Any  changes  to  tl  CS-ACTION-ENTRY  must  be 
reflected 

in  CDPlOB  in  the  J  code  generation  section.  The 
length  of  CS-STRING2  has  been  hard  coded  in  the 
generated  C  code  in  paragraph 
2 lO-GEN-MOVE-OF-TABLES . 

*****  THE  CONCEPTUAL  SCHEMA  ACTION  LIST 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CSQUAL 

PURPOSE:  CONCEPTUAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  FOR 
THE  REQUEST'S  QUALIFICATION 

NOTE ! I ! ! ! 

This  table  is  cloned  as  CSQUALX  in  CDPRE4 .  If  it 
is  changed,  CSQUALX  must  be  changed  also. 

THE  CONCEPTUAL  SCHEMA  QUALIFY  LIST 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  CURTAB 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  EOD 

PURPOSE:  SQL  END  OF  DATA  DEFINITION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP  * 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ERRFS 

PURPOSE:  ERRFS. INC  -  FILE  I/O  PRIMITIVES  (FILE  SERVICES) 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IISS  ERROR  CODES 

THIS  FILE  DEFINES  THE  FS  STATUS 
CODES  IN  COBOL  FORMAT 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ESAL 

PURPOSE;  EXTERNAL  SCHEMA  ACTION  LIST 
LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  EXTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  REQUEST 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ESQUAL 

PURPOSE:  EXTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  EXTERNAL  SCHEMA  INFORMATION  FOR  THE  NDML 
QUALIFICATION 


THE  EXTERNAL  SCHEMA  QUALIFY  LIST 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  FILSTAT 

PURPOSE:  VARIABLE  DEFINITION  FOR  FILE  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


FILE  USAGE  FILE  STATUS  PARAMETER 


FILSTAT 

FILE  USAGE  FILE  STATUS  PARAMETER 

SIZE  AND  THE  88  VALUE  ARE  PROBABLY  MACHINE 

DEPENDENT 

(THIS  IS  FOR  VAX-11  COBOL) 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  FLDELST 

PURPOSE:  PROVIDE  A  TEMPORARY  LIST  OF  FILES  OF  CODE  TO  BE 

DELETED 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THE  NAMES  OF  FILES  AND  MODULES  OF  OBSOLETE 
GENERATED  CODE  ARE  STORED  IN  THIS  TABLE  DURING 
THE  PRECOMPILATION  OF  A  SINGLE  USER  MODULE. 
THEY  MUST  BE  STORED  UNTIL  PRECOMPILATION  IS 
COMPLETE  AND  SUCCESSFUL  AND  THEN  THE  NAMES 
ARE  USED  TO  DELETE  THE  FILES. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  FORVAR 

PURPOSE:  FORTRAN  VARIABLE  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION; 


THIS  TABLE  HOLDS  THE  ORIGINAL  FORTRAN  VARIABLE 
AND  ITS  GENERATED  SIX-CHARACTER  COUNTERPART. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ISAL 

PURPOSE:  INTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION; 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  ABOUT  AN 
NDML  REQUEST 


THE  INTERNAL  SCHEMA  ACTION  LIST 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  ISQUAL 

PURPOSE;  INTERNAL  SCHEMA  QUALIFY  LIST 
LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  QUALIFICATION 


THE  INTERNAL  SCHEMA  QUALIFY  LIST 
DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  JQGTBL 

PURPOSE;  JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 

SUBTRANSACTIONS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  OCCTAB 
PURPOSE:  OCCURS  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  ABOUT  THE  SUBSCRIPTING 
STRUCTURE  FOR  REPEATING  FIELDS/GROUPS.  THERE 
MAY  BE  MULTIPLE  ENTRIES  IN  THE  TABLE  HAVING 
THE  SAME  SUBTRANS,  RTNO  AND  NEST-ID. 


3-82 


PS  620341200 
30  September  1990 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  P5DFS 

PURPOSE:  DATAFIELD  TABLE  -  HOLDS  ALL  DATAFIELD  NUMBERS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


FOR  A  RECORD/ DATABASE  COMBINATION 
FOR  CODASYL 

-  USED  TO  TRACK  ALL  FIELDS,  EVEN  IF 
NOT  SELECTED,  FOR  BETTER  IMPACT 
PROCESSING 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  RFTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


THE  RESULT  FIELD  TABLE 

WHEN  CHANGING  THE  STRUCTURE  OF  THIS  TABLE 
BE  SURE  TO  CHANGE  THE  LAYOUT  IN  THE 
LINKAGE  SECTION  OF  THE  DRS  (CDSOl) 

WHICH  WAS  COPIED  FROM  THIS. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  SBSTLST 

PURPOSE:  WS  DEFINITION  FOR  THE  SUBSTITUTION  LIST  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


SUBSTITUTION-LIST  REPRESENTS  THE  INPUT  TABLE 
OF  SUBSTITUTION  PARAMETERS  FOR  THE  CDMACR 
MACRO  EXPANSION  SUBROUTINE 
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DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  S ETTAS 

PURPOSE:  LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


SET  TABLE  TO  KEEP  TRACK  OF  CODASYL  NDML  REQUESTS 
IN  TERIIS  OF  OWNER  AND  MEMBER  RELATIONSHIPS 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  SQLVAR 

PURPOSE:  SQL  VARIABLE  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  HOLDS  THE  VARIABLES  DECLARED  IN  THE 
EXEC  SQL  BEGIN  DECLARE  SECTION. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP  * 

MODULES  FOR  ERROR  HANDLING  * 


3-84 


PS  620341200 
30  September  1990 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  SUBBOOL 

PURPOSE;  SUBTRANS  BOOLEAN  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  THE  BOOLEAN  OPERATORS,  PARENTHESES,  AND 
CONDITIONS  WHICH  CAN  BE  SATISFIED  AT  THE  INTERNAL 
SCHEMA  LEVEL,  FOR  EACH  SUBTRANSACTION. 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  SUBPROC 

PURPOSE:  SUBTRANSACTION  PROCESSES  ID  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION; 


THIS  TABLE  MUST  HAVE  THE  SAME  NUMBER  OF  OCCURS 
AS  THE  RITABLE.INC  AND  QITABLE.INC  SINCE  THEY  ARE 

PARALLEL 

TABLES , 


DOCGROUP  PS41200  Include  File  Description 


FILE  NAME:  UVABBR 

PURPOSE:  USER  VIEW  ABBREVIATION  LIST 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION; 
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1 CDVERSM  1 
+ - + - + 


+ - + - + - + - + 

!  .  1 

+  “~+~”~+  H —  -I - — — - -) — — -j - 1- 

1 (CONT) I  ISQLOSQ  |  j SQLADR  ]  ] SQLABl  \  | (CONT) | 

+ - 55+  + - +  + - +  + - +  + - 64  + 


+ - 

1 CDFOl 
+ - + — 

J 

-+ 

i 

-+ 

1 

1 

1 

1 

1 

— + - + 

1 

+ - + - + 

+  + 

-+ 

1 

+ - + - + 

+ — + - + 

(CONT) 1 

1 SQLSCC  1 

1 SQLTOC 

i 

1 SQLOSQ  1 

1 (CONT) 1 

- 56+ 

+ - + 

+ - 

-+ 

+ - + 

+ - 65  + 

I CDPRE  I 
+ - + - + 


I (CONT) I  lERRPRO  |  | RPTERR  | 
+ 57+  + - +  + - + 


+ 


+ - + 

I CDCJOB  1 

•t- - + - + 


62 


+ — + - +  + - + - +  + - + - + 

I (CONT) I  [CDMACR  |  |OUTFIL  | 

+ - 57+  + - +  + - + 
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63 

+ - + 

I CDLKLUW  I 

+ + + 

I 

+ - + - ++ - + - + 

.  !  .  .  i  .  .  !  .  .  !  .1 

I (CONT) I  ISQLABl  |  | SQLEXE  |  | SQLADl  |  | (CONT) | 

+ - 58+  + - +  + - +  + - +  + - 66+ 


+ - + 

I CDVERSM  I 
+ + - 1- 


+ — + - +  + - + - +  + - + - +  + - + - +  + — + - + 

I (CONT) I  I SQLEXE  |  | SQLADl  (  | SQLFCH  |  | (CONT) | 

+ - 59+  + - +  + - +  + - +  + - 67  + 


65 

+  + 

|CDF01  I 
+ - + - + 

I 

+ - + - ++ - + - + 

I  I  I  I  I 

+ — + - +  + + +  + - + - +  + - + - +  + — + - + 

( (CONT) I  (SQLADR  |  | SQLABl  ]  | SQLEXE  |  | (CONT) | 

+““~~60+  — — — — — — — -j-  -I — - - -) - 


+ - + 

1 CDLKLUW  1 
+ + + 


+ - + - + - + - + 


+~ — ).  — -j - ). 

I (CONT) I  I SQLFCH  |  | SQLCLS  |  | ERRPRO  | 

+ - 63+  + - +  + - +  + - + 
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67 


1 CDVERSM  I 
+ + + 

_ 1^ _ 


+ — + - +  + - + - +  + - + - +  + - + - + 


I (CONT) I 
+——““64+ 


I CDRPXRF  I 
+ - 69+ 


CDRPESU 


CDDGAP 


+ — + - + 

I (CONT) I 
+ - 70+ 


+ - + 

jCDFOl  1 
+ - + - + 


68 


-++- 


+ — + - +  + - + - +  + - + - +  + - + - +  + — + - + 

I (CONT) 1  ISQLADl  j  [ SQLFCH  |  | SQLCLS  |  | (CONT) | 

+ - 65+  + - +  + - +  + - +  + - 71+ 


+ - + 

1 CDRPXRF  1 
+ + + 


69 


+ - + - +  + - + - +  + - + - +  + - + - +  + — + - + 


SQLSCA 


SQLBSl 


SQLSCH 


-+ 


SQLSCC 


I (CONT) I 
+ 72  + 


+ - + 

I CDVERSM  I 
+ + + 


+ - 

1 

1 

1 

1 

- + 

1 

+ — + - + 

+ 

1  ^ 

^  1 

-+ 

1 

+ - + - + 

+ - + - + 

1 (CONT) 1 

1 CDINSSM  1 

jCDINSNM 

1 

1 CDDBMSS  1 

1 ERRPRO  1 

+ - 67+ 

O 

1  1 

1 

1 

1 

i 

1 

1 

-+ 

1 

+ - + - + 

-+ 

1 

+ - + - + 

1 

+ — + - + 

1  CDS DATE 
+ - 

1 

-+ 

1 SQLSCA  1 
+ - + 

1 SQLBSl 
+ - 

1 

-+ 

1 SQLSCH  1 
+ - + 

1 (CONT) 1 
+ 73  + 
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71 


jCDFOl  I 
+ - + - + 


+ - + - + - + - + 

till 

+ — + - +  + - + - +  + - + - +  + - + - + 

1 (CONT) I  jSQLTFL  |  | SQLOPN  |  | SQLWNR  | 

+ - 68+  + - +  + - +  + - + 


1 CDRPXRF  I 
+ - + - + 


+ - + - ++ - + - + 

I  I  I  I  I 

+  — 4"““'"“+  -j-  —— — —4-  4-  — — — — “4-  -(-  ——4-  —  — -"4- 

1 (CONT) 1  ISQLTOC  |  | SQLOSQ  |  | SQLADR  |  | (CONT) | 
+ - 69+  + - +  + - +  + - +  + 74  + 


I CDINSNM  1 
+ - + - + 


+ - + - ++ - + - + 


+ - + - +  + - 4- - +  + - + - +  + - + - +  + — + - 4 

I (CONT) I  ISQLSCC  |  | SQLTFL  |  | SQLOPN  |  | (CONT) | 

+ - 70+  + - +  + - +  + - +  + - 75  + 


+ — ~ — ~ — ~+ 
I CDRPXRF  I 

4 - 4 - 4 


4 - 4 - 44 - 4 - 4 


4 - 4 - 4  4 - 4 - 4  4 - 4 - 4  4 - 4 - 4  4 - 4 - 4 

1 (CONT) 1  [SQLABl  |  | SQLEXE  [  [ SQLADl  1  | (CONT) | 

4 - 724  + - +  + - +  + - +  + - 76  + 
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+ - + 

I CDINSNM  1 
+ + + 


+ - + - ++ - + 


75 


+ 


+ — + - +  + - + - +  + - + - +  + - + - +  + — + - + 

I (CONT) I  ISQLOSQ  \  | SQLADR  |  | SQLABl  \  | (CONT) | 

+ - 73+  + - +  + - +  + - +  + - 77  + 


+ - + 

I CDRPXRF  1 
+ + + 

I 

+ - + - ++ - + - + 

II  I  II 

+ — + - +  + - + - +  + - + - 1-  + - + - +  + — + - + 

1 (CONT) I  ISQLFCH  |  ] CDRPRSU  1  | CDRPDFU  |  | (CONT) ] 

+ - 74+  + - +  + - + - +  + - + - +  + - 78  + 


1 SQLSCA  1  I SQLSCA  j 
+ - +  + - + 


76 


+ - + 

1 CDINSNM  I 
+ + + 


+ — + - +  + - + - +  + - + - + 

I (CONT) I  jSQLEXE  ]  | ERRPRO  | 

+ - 75+  + - +  + - + 


+ - + 

[ CDRPXRF  I 

+ - + - + 

i 

+ - + - + - + + 


78 


+ — + - +  + - + - +  + - + - +  + - + - + 

1 (CONT) 1  ICDRPSM  |  | SQLCLS  |  | ERRPRO  | 

+ - 76+  + - +  + - +  + - + 
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APNAME 

>*••24 

CDS DATE 

BLiDCO  •  •  • 

. 1 

CDSLFN 

....  56 

CDCJOB 

....  57 

CDSLMN 

CDCREFO 

CDUPDLW 

.  .  .19 

CDDBMSS 

CDUPDNM 

....  2 

CDDGAP 

CDVERLW 

CDECHK. . 

CDVERSM 

.  .  .52 

CDFOl  . 

• • • *56 

CLSFIL 

CDFIRP 

... .37 

ERRPRO 

CDFLRP 

GENFIL 

CDFORP 

....  25 

GENRPD . . 

• • • • 27 

CDFUNC 

INPFIL 

CDGDF. . . 

. 3 

LOGANA. . 

....  28 

CDGETOF 

LOWUPP 

CDIDFU. . 

. 4 

NSEND 

CDIDIU. . 

•  •  •  •  •  5 

OPNFIL 

CDIGAP 

•  •  •  •  •  7 

OUTFIL 

CDINSLW. 

....  12 

RCMOD. . . 

....  16 

CDINSNM 

.  .  .70 

RCV 

CDINSSM 

•  •  •  •  3 

RPTERR 

CDIRSU. . 

....  13 

SQLABl 

CDLKLUW 

...  54 

SQLADl 

CDMOl 

SQLADR 

CDMACR 

SQLBSl 

CDPIO 

SQLCLS 

CDPll 

SQLEXE 

CDP13 . . . 

....  14 

SQLFCH 

CDP14 

SQLLOl 

CDPIC 

SQLOPN 

CDPRE  . 

....  39 

SQLOSQ 

CDPREl 

SQLSCA 

CDPRE2 

SQLSCC 

CDPRE6 

SQLSCH 

CDPRE7 

SQLTFL 

CDPRE8 

SQLTOC 

CDPRE8C 

SQLWNR 

CDPRE8D 

CDQPC 

CDQPS 

CDRPDFU 

.  .  .76 

CDRPESU 

CDRPRSU 

.  .  .76 

CDRPSM 

CDRPXRF 

...  69 

CDRSFN 

....  53 

CDRSMN 

CDRTSND. 

_ 15 

3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 


3-106 


SECTION  4 


PS  620341200 
30  September  1990 


QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

"Testing”  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  IS  practical  and  possible  in  each  routine  should  be 
performed. 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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